Node / meshtastic / Meshtastic-Android / files / core / data / src / commonMain / kotlin / org / meshtastic / core / data / repository / FirmwareReleaseRepositoryImpl.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2025-2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.data.repository

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787kotlinx.coroutines.flow.Flow

Tff7b72import T7ee787kotlinx.coroutines.flow.flow

Tff7b72import T7ee787org.koin.core.annotation.Single

Tff7b72import T7ee787org.meshtastic.core.common.util.nowMillis

Tff7b72import T7ee787org.meshtastic.core.common.util.safeCatching

Tff7b72import T7ee787org.meshtastic.core.data.datasource.FirmwareReleaseJsonDataSource

Tff7b72import T7ee787org.meshtastic.core.data.datasource.FirmwareReleaseLocalDataSource

Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareRelease

Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareReleaseEntity

Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareReleaseType

Tff7b72import T7ee787org.meshtastic.core.database.entity.asExternalModel

Tff7b72import T7ee787org.meshtastic.core.model.util.TimeConstants

Tff7b72import T7ee787org.meshtastic.core.network.FirmwareReleaseRemoteDataSource

Tff7b72import T7ee787org.meshtastic.core.repository.FirmwareReleaseRepository

Tf0883e@Single

Tff7b72open Tff7b72class T56d364FirmwareReleaseRepositoryImplTb4b4b4(

Tff7b72private Tff7b72val Te6edf3remoteDataSourceTb4b4b4: Te6edf3FirmwareReleaseRemoteDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3localDataSourceTb4b4b4: Te6edf3FirmwareReleaseLocalDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3jsonDataSourceTb4b4b4: Te6edf3FirmwareReleaseJsonDataSourceTb4b4b4,

Tb4b4b4) Tb4b4b4: Te6edf3FirmwareReleaseRepository Tb4b4b4{

T8b949e/**

* A flow that provides the latest STABLE firmware release. It follows a "cache-then-network" strategy:

* 1. Immediately emits the cached version (if any).

* 2. If the cached version is stale, triggers a network fetch in the background.

* 3. Emits the updated version upon successful fetch. Collectors should use `.distinctUntilChanged()` to avoid

* redundant UI updates.

*/

Tff7b72override Tff7b72val Te6edf3stableReleaseTb4b4b4: Te6edf3FlowTff7b72<Te6edf3FirmwareRelease?Tff7b72> Tff7b72= Te6edf3getLatestFirmwareTb4b4b4(Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3STABLETb4b4b4)

T8b949e/**

* A flow that provides the latest ALPHA firmware release.

*

* @see stableRelease for behavior details.

*/

Tff7b72override Tff7b72val Te6edf3alphaReleaseTb4b4b4: Te6edf3FlowTff7b72<Te6edf3FirmwareRelease?Tff7b72> Tff7b72= Te6edf3getLatestFirmwareTb4b4b4(Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3ALPHATb4b4b4)

Tff7b72private Tff7b72fun Td2a8ffgetLatestFirmwareTb4b4b4(

Te6edf3releaseTypeTb4b4b4: Te6edf3FirmwareReleaseTypeTb4b4b4,

Te6edf3forceRefreshTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72falseTb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3FlowTff7b72<Te6edf3FirmwareRelease?Tff7b72> Tff7b72= Te6edf3flow Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3forceRefreshTb4b4b4) Tb4b4b4{

Te6edf3invalidateCacheTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e// 1. Emit cached data first, regardless of staleness.

T8b949e// This gives the UI something to show immediately.

Tff7b72val Te6edf3cachedRelease Tff7b72= Te6edf3localDataSourceTb4b4b4.Te6edf3getLatestReleaseTb4b4b4(Te6edf3releaseTypeTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3cachedRelease Tff7b72!Tff7b72= Tff7b72nullTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffEmitting cached firmware for Tffd700$Te6edf3releaseTypeTa5d6ff (isStale=Tffd700${Te6edf3cachedReleaseTb4b4b4.Te6edf3isStaleTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff)Ta5d6ff" Tb4b4b4}

Te6edf3emitTb4b4b4(Te6edf3cachedReleaseTb4b4b4.Te6edf3asExternalModelTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3emitTb4b4b4(Tff7b72nullTb4b4b4)

Tb4b4b4}

T8b949e// 2. If the cache was fresh and we are not forcing a refresh, we're done.

Tff7b72if Tb4b4b4(Te6edf3cachedRelease Tff7b72!Tff7b72= Tff7b72null Tff7b72&Tff7b72& Tff7b72!Te6edf3cachedReleaseTb4b4b4.Te6edf3isStaleTb4b4b4(Tb4b4b4) Tff7b72&Tff7b72& Tff7b72!Te6edf3forceRefreshTb4b4b4) Tb4b4b4{

Tff7b72returnTf0883e@flow

Tb4b4b4}

T8b949e// 3. Cache is stale, empty, or refresh is forced. Fetch new data.

Te6edf3updateCacheFromSourcesTb4b4b4(Tb4b4b4)

T8b949e// 4. Emit the final, updated value from the cache.

T8b949e// The `distinctUntilChanged()` operator on the collector side will prevent

T8b949e// re-emitting the same data if the cache wasn't actually updated.

Tff7b72val Te6edf3finalRelease Tff7b72= Te6edf3localDataSourceTb4b4b4.Te6edf3getLatestReleaseTb4b4b4(Te6edf3releaseTypeTb4b4b4)

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffEmitting final firmware for Tffd700$Te6edf3releaseTypeTa5d6ff from cache.Ta5d6ff" Tb4b4b4}

Te6edf3emitTb4b4b4(Te6edf3finalReleaseTff7b72?.Te6edf3asExternalModelTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4}

T8b949e/**

* Updates the local cache by fetching from the remote API, with a fallback to a bundled JSON asset if the remote

* fetch fails.

*

* This method is efficient because it fetches and caches all release types (stable, alpha, etc.) in a single

* operation.

*/

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffupdateCacheFromSourcesTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3remoteFetchSuccess Tff7b72=

Te6edf3safeCatching Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffFetching fresh firmware releases from remote API.Ta5d6ff" Tb4b4b4}

Tff7b72val Te6edf3networkReleases Tff7b72= Te6edf3remoteDataSourceTb4b4b4.Te6edf3getFirmwareReleasesTb4b4b4(Tb4b4b4)

T8b949e// The API fetches all release types, so we cache them all at once.

Te6edf3localDataSourceTb4b4b4.Te6edf3insertFirmwareReleasesTb4b4b4(Te6edf3networkReleasesTb4b4b4.Te6edf3releasesTb4b4b4.Te6edf3stableTb4b4b4, Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3STABLETb4b4b4)

Te6edf3localDataSourceTb4b4b4.Te6edf3insertFirmwareReleasesTb4b4b4(Te6edf3networkReleasesTb4b4b4.Te6edf3releasesTb4b4b4.Te6edf3alphaTb4b4b4, Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3ALPHATb4b4b4)

Tb4b4b4}

Tb4b4b4.Te6edf3isSuccess

T8b949e// If remote fetch failed, try the JSON fallback as a last resort.

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3remoteFetchSuccessTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{ Ta5d6ff"Ta5d6ffRemote fetch failed, attempting to cache from bundled JSON.Ta5d6ff" Tb4b4b4}

Te6edf3safeCatching Tb4b4b4{

Tff7b72val Te6edf3jsonReleases Tff7b72= Te6edf3jsonDataSourceTb4b4b4.Te6edf3loadFirmwareReleaseFromJsonAssetTb4b4b4(Tb4b4b4)

Te6edf3localDataSourceTb4b4b4.Te6edf3insertFirmwareReleasesTb4b4b4(Te6edf3jsonReleasesTb4b4b4.Te6edf3releasesTb4b4b4.Te6edf3stableTb4b4b4, Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3STABLETb4b4b4)

Te6edf3localDataSourceTb4b4b4.Te6edf3insertFirmwareReleasesTb4b4b4(Te6edf3jsonReleasesTb4b4b4.Te6edf3releasesTb4b4b4.Te6edf3alphaTb4b4b4, Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3ALPHATb4b4b4)

Tb4b4b4}

Tb4b4b4.Te6edf3onFailure Tb4b4b4{ Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{ Ta5d6ff"Ta5d6ffFailed to cache from JSON: Tffd700${Tffa657itTb4b4b4.Te6edf3messageTffd700}Ta5d6ff" Tb4b4b4} Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffinvalidateCacheTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3localDataSourceTb4b4b4.Te6edf3deleteAllFirmwareReleasesTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e/** Extension function to check if the cached entity is stale. */

Tff7b72private Tff7b72fun Te6edf3FirmwareReleaseEntityTb4b4b4.Td2a8ffisStaleTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72= Tb4b4b4(Te6edf3nowMillis Tff7b72- Tff7b72thisTb4b4b4.Te6edf3lastUpdatedTb4b4b4) Tff7b72> Te6edf3CACHE_EXPIRATION_TIME_MS

Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3CACHE_EXPIRATION_TIME_MS Tff7b72= Te6edf3TimeConstantsTb4b4b4.Te6edf3ONE_HOURTb4b4b4.Te6edf3inWholeMilliseconds

Tb4b4b4}

Tb4b4b4}